III NPC Chopper / HELI_CLASSIC para GTA San Andreas
===================================================

Autor: Johnzi

Obrigado por baixar e usar este mod.

Este mod adiciona ao GTA San Andreas o Police Chopper clássico no estilo
GTA III / Vice City / LCS, usando um sistema interno próprio chamado
HELI_CLASSIC.

Importante:
este chopper NÃO usa o helicóptero nativo do GTA San Andreas como veículo
principal. Ele NÃO é o Police Maverick / Polmav comum do SA e NÃO usa a física
nativa do CHeli do San Andreas para se mover, atacar ou cair.

O objetivo deste mod é recriar o chopper policial clássico dentro do GTA SA
como um subsistema separado, com comportamento inspirado no GTA III.


REQUISITOS
==========

1. GTA San Andreas PC 1.0

   Este mod foi feito para o GTA San Andreas clássico de PC, de preferência
   com o executável 1.0 US.

   Não use:
   - GTA San Andreas Definitive Edition
   - GTA SA Steam novo sem downgrade
   - executáveis 1.01 / 2.0 sem compatibilidade

2. ASI Loader

   O arquivo IIIHelibase.SA.asi não carrega sozinho em um GTA limpo.
   Você precisa ter um ASI Loader instalado no GTA SA.

   Exemplos comuns:
   - Ultimate ASI Loader
   - Silent ASI Loader
   - dinput8.dll ASI Loader

   Se o mod não funcionar e o arquivo heli_classic_runtime.log não aparecer
   na pasta principal do GTA, provavelmente o ASI não foi carregado.
   Nesse caso, verifique a instalação do ASI Loader.

3. Backup recomendado

   Faça backup da sua pasta do GTA SA ou, no mínimo, destes arquivos:

   data\vehicles.ide
   data\handling.cfg

   Este pacote inclui arquivos data já preparados. Se você usa outros mods,
   talvez seja necessário mesclar manualmente as linhas em vez de substituir
   os arquivos inteiros.


COMO INSTALAR
=============

Abra a pasta:

Put the files on your GTA SA folder

Copie TODO o conteúdo de dentro dela para a pasta principal do seu GTA SA.

Exemplo correto:

GTA San Andreas\
    heli_classic.ini
    audio\
        heli_classic\
            Bullet1.wav
            Bullet2.wav
            Bullet3.wav
            Chatter1.wav
            ...
            rotor1.wav
            rotor2.wav
            rotor3.wav
    data\
        vehicles.ide
        handling.cfg
    scripts\
        IIIHelibase.SA.asi
        chopper.dff
        CHOPPER.TXD
        spotlight.txd

Não coloque a pasta "Put the files on your GTA SA folder" dentro do GTA.
Você deve copiar o CONTEÚDO dela para dentro da pasta principal do jogo.


NÃO MEXA / NÃO RENOMEIE
=======================

Para evitar bugs, não renomeie, não mova e não edite estes arquivos:

scripts\IIIHelibase.SA.asi
scripts\chopper.dff
scripts\CHOPPER.TXD
scripts\spotlight.txd
heli_classic.ini
audio\heli_classic\*.wav

Também não altere no heli_classic.ini:

[612]
name=chopper
type=heli_classic
archetype=gta3_police_chopper
suppress_native_heli_pipeline=true

O model ID 612 é usado como o slot do chopper clássico.
Trocar esse ID ou tentar transformá-lo em um helicóptero nativo do GTA SA
pode quebrar o funcionamento do mod.


O QUE O MOD FAZ
===============

Quando o CJ atinge um nível de procurado suficiente, o mod cria o Police
Chopper clássico usando o sistema HELI_CLASSIC.

Recursos principais:

- Chopper policial clássico no estilo GTA III.
- Não usa o Polmav nativo como chopper principal.
- Não usa a física nativa de helicóptero do GTA SA.
- Spawn durante perseguições policiais.
- Dois choppers em 6 estrelas.
- Movimento, ataque e queda inspirados no GTA III.
- Holofote / spotlight funcional.
- Luz branca frontal.
- Luz vermelha traseira piscando.
- Sons próprios de rotor.
- Sons próprios de tiros.
- Rádio / chatter policial.
- Poeira de rotor próxima ao chão.
- Dano por armas e RPG.
- Recompensa e crime ao derrubar o chopper.
- Integração com HUD, minimapa e presença policial.

Nota sobre compatibilidade:
o mod pode usar uma pequena camada nativa invisível apenas para identificação,
permitindo que o GTA SA e outros mods reconheçam o HELI_CLASSIC como um
helicóptero policial. Essa camada não é o chopper principal, não renderiza,
não colide, não tem IA própria, não usa armas nativas e não substitui o
comportamento clássico do HELI_CLASSIC.


COMO TESTAR
===========

1. Inicie o GTA SA.
2. Entre no jogo em uma área externa.
3. Pegue 3 ou mais estrelas de procurado.
4. Aguarde o chopper aparecer.
5. Em 6 estrelas, podem aparecer dois choppers.

O chopper não deve aparecer enquanto o CJ estiver em interiores.
Se o CJ estiver mergulhando, o chopper deve permanecer acima da superfície
da água.


ARQUIVO DE LOG
==============

O mod cria este arquivo na pasta principal do GTA SA:

heli_classic_runtime.log

O log ajuda a diagnosticar problemas.

Ele é reiniciado a cada nova execução do GTA SA e possui limite de tamanho.
Isso evita logs gigantes em sessões longas.

Se precisar pedir ajuda, envie esse arquivo junto com uma explicação do
problema.


DIAGNÓSTICO RÁPIDO
==================

Problema:
o mod não faz absolutamente nada.

Verifique:
- Existe heli_classic_runtime.log na pasta principal do GTA?

Se NÃO existe:
- O ASI Loader não está instalado ou não está carregando o ASI.
- Verifique dinput8.dll, vorbisFile.dll ou outro ASI Loader instalado.

Se existe:
- Abra o log e procure as primeiras linhas.

Correto:

HELI_CLASSIC CONFIG: loaded: heli_classic.ini
HELI_CLASSIC CONFIG: section [612] parsed
HELI_CLASSIC REGISTRY: model 612 registered as ClassicVehicleType::HeliClassic

Problema:
CONFIG not found.

Solução:
- Coloque heli_classic.ini na pasta principal do GTA SA.
- Opcionalmente, também pode colocar em scripts\heli_classic.ini.

Problema:
chopper.dff not found / chopper.txd not found.

Solução:
- Verifique se estes arquivos estão em scripts:

scripts\chopper.dff
scripts\CHOPPER.TXD

Problema:
spotlight.txd not found ou o holofote não aparece.

Solução:
- Verifique:

scripts\spotlight.txd

Problema:
os sons não tocam.

Solução:
- Verifique:

audio\heli_classic\rotor1.wav
audio\heli_classic\Bullet1.wav
audio\heli_classic\Chatter1.wav

Problema:
aparece o Police Maverick / Polmav nativo em vez do chopper clássico.

Solução:
- Verifique se heli_classic.ini está carregando.
- Verifique se suppress_native_heli_pipeline=true.
- Verifique se o ASI correto está em scripts\IIIHelibase.SA.asi.


SOBRE MODLOADER
===============

Este pacote foi montado para instalação direta na pasta do GTA SA.

Alguns arquivos podem funcionar via ModLoader, mas a instalação mais segura
para este pacote é copiar o conteúdo diretamente para a pasta principal do
GTA SA.

Se você quiser usar ModLoader:
- mantenha o ASI em scripts ou garanta que seu ASI Loader carregue ASIs do mod;
- mantenha heli_classic.ini na pasta principal do GTA SA ou em scripts;
- mantenha os arquivos de áudio no caminho audio\heli_classic.

Para evitar problemas, a instalação direta é recomendada.


COMPATIBILIDADE
===============

Recomendado:
- GTA San Andreas PC 1.0
- ASI Loader instalado
- jogo limpo ou pouco modificado

Pode dar conflito com:
- mods que substituem vehicles.ide inteiro;
- mods que alteram o model ID 612;
- mods que alteram fortemente o sistema de polícia / wanted level;
- mods que substituem CHeli / Polmav de forma agressiva;
- outros ASIs que hookam armas, projéteis, helicópteros, coronas ou radar.


CRÉDITOS / AGRADECIMENTOS
=========================

Autor:
- Johnzi

Agradecimentos especiais:
- Equipe e contribuidores do RE3
- Comunidade e contribuidores do GTA San Andreas Reversed
- Plugin-SDK
- Visual Studio
- Magic.TXD
- Blender

Este mod existe para preservar e portar o Police Chopper clássico para o
GTA San Andreas. Ele foi feito com foco em fidelidade ao comportamento
GTA III-style, mas usando uma arquitetura própria para funcionar dentro do
San Andreas.

Divirta-se.